home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / DATABASE / ESDV21.ZIP;1 / README.1ST < prev    next >
Encoding:
Text File  |  1993-02-18  |  23.1 KB  |  552 lines

  1. _________________________________________________________________________
  2.   _____________________________________________________________________
  3.       |                                                         |
  4.       |        The ENSONIQ EPS Sample Database (ESD) v2.01      |
  5.   ____|_________________________________________________________|______
  6. _________________________________________________________________________
  7.  
  8. Written February 1993 by:    Joe Santacroce
  9.                              DATA Solutions
  10.                              9 Neversink Dr.
  11.                              Newburgh, NY 12550
  12.                              [914]566-0890
  13.  
  14.                  (First version written in November of 1992)
  15.                       (See history at end of this file)
  16. _________________________________________________________________________
  17.  
  18. ========================================================================
  19. First things first I guess....
  20.  
  21.      As sort of a little payback for all I've gotten out of MIDILink, 
  22.      I offer this to any MIDILink user who might get some use out of 
  23.      it. You can freely distribute this program as long as all the files 
  24.      are distributed as is, with no modifications whatsoever.
  25.      
  26.      USE THIS AT YOUR OWN RISK..  I TAKE NO RESPONSIBILITY WHATSOEVER.
  27.      FOR ESD or EDIR. I USE THIS ALL THE TIME. YOU SHOULD HAVE NO 
  28.      PROBLEMS EITHER.
  29.  
  30.      ESD is written in Clipper 5.01 using the DCLIP Library from Donnay 
  31.      Software Designs, Grumplib from Grumpfish Inc., Superlib from 
  32.      Functional Software and R&R Report Writer from Concentric Data. 
  33.      Each holds copyrights to their respective libraries and source 
  34.      code. They are used and distributed under royalty free runtime 
  35.      licensing agreements.
  36.  
  37.  
  38. =====================================================================
  39.  
  40. This is a free application to anyone who wants to use it, and I will 
  41. try to make improvements and fixes where I can. But, this will depend 
  42. on the mood I'm in, the mood the wife's in, time schedule and etc. etc.
  43.  
  44.          Thanks for the feedback from everyone so far.
  45.  
  46. =====================================================================
  47.  
  48. =====================================================================
  49. =====================================================================
  50.  
  51. Now using EDIR.EXE (Copyright and courtesy of Resident MIDILink 
  52. Tech Wizard Mark Pulver aka JWalsh Toys) to read EPS Disks. EDIR
  53. appears to be incorporated directly into the application for a more 
  54. seamless and easier to use approach. This utility is included in 
  55. this package free of charge from JWalsh Toys. However, JWalsh Toys 
  56. has total rights to the utility and may at any future time do with 
  57. the program however they wish. I appreciate it being made available to
  58. be used and distributed with ESD.
  59.  
  60. Thanks Mark...
  61.  
  62. It's pretty much self explantory as is most of the rest of the program.
  63. After loading ESD just pop in an EPS disk in the A: or B: drive. Choose 
  64. IMPORT and the appropriate drive. Press ENTER to Re-Read the disk, W to 
  65. Write the info to a text file, or Q to Quit. Don't worry about pressing 
  66. W)rite too many times because the import process automatically deletes 
  67. any duplicate disk reads.
  68.  
  69. If the disk already exists in your sample database, it will not be
  70. added. Numbers are automatically assigned to disks during IMPORT but 
  71. you can edit the numbers afterwards. The idea here is to feed all your
  72. existing disks in at once and number them as you go along. Then as you
  73. add new sample disks, just read them in and they will be numbered
  74. beginning with the last number currently in the database + 1.
  75.  
  76. The import process will automatically run if it finds that you Wrote
  77. out the disk info with the W)rite command.
  78.  
  79. Upgrade Note:
  80.  
  81. I would recommend that you create a new sample database and feed all
  82. your disks back into it if you are upgrading. The reason is because of
  83. EDIR. It can properly distinguish between instruments, sound banks and
  84. songs and and are now properly placed in the database and reported. 
  85.  
  86. =====================================================================
  87. =====================================================================
  88.    
  89. =====================================================================
  90.  
  91. Ok, what is ESD?
  92.  
  93. This program is for EPS Sampler users (and EPS 16+ of course) who have 
  94. a collection of sample disks but no way to easily keep track of them. 
  95. I, am (was) one of those users.
  96.  
  97. I haven't tried it with MIRAGE samples, if EDIR reads them, it should 
  98. work.
  99.  
  100. Note:
  101.         Once ASR-10 disks are released, If Mark Pulver (JWalsh Toys!)
  102.         upgrades EDIR to read ASR-10 disks, then possibly only EDIR.EXE 
  103.         will be required to be upgraded. 
  104.  
  105.  
  106.   Features: -Reads Ensoniq EPS and EPS16+ (and rackmounts) Disks
  107.             -Automatically Imports the disk information 
  108.        ** !! ** Now Includes Label Printing for EPS Disks ** !! **
  109.             -Menu Driven easy to use Browse/View/Edit/Search/Query/List
  110.             -Reads ANY IBM file type in addition to ENSONIQ EPS Disks
  111.                    You determine what types of files are imported
  112.                    by adding that file types Extension to the 
  113.                    Extensions Lookup Table. 
  114.             -Interactive Query/Filter for all functions
  115.                    Now has the ability to store queries that you
  116.                    create and use them anywhere throughout the 
  117.                    application so you don't have to recreate a query 
  118.                    when you go from Browse/Edit to List Mode and then
  119.                    to print reports. Once you create a set of standard
  120.                    queries you won't have to any more.
  121.             -Several sorted 'Canned' Reports for both EPS and Non-EPS 
  122.             -Build your own quick reports/lists for all files
  123.             -All reports print to both screen or printer (some to file too!)
  124.             -Point and shoot index selection
  125.             -Pop-up indexed key searches for instantly locating a sample
  126.             -Pop-ups for Types, Qualities, Sources
  127.             -New Help System throughout with help index (Press F1 twice)
  128.             -Notepad / Text Editor 
  129.             -Easy to use
  130.             -Free **!!** (but don't ask for much in the way of changes (g))
  131.             -Should run on just about anything. (If not, give a holler!)
  132.                        (might be a tad slow on SX and lower powered PC's)
  133.             -Loves EMS memory if ya got it. Software caches such as
  134.              Hyper Disk, PC-Kwik, SMARTDRV, NCACHE and others all work 
  135.              well the system. Just don't reboot with files open though 
  136.              or you'll probably have some corrupted data files.
  137.              Actually, the cache will make a !!!!BIG!!!! difference in
  138.              how the program performs and I recommend one highly. Even 
  139.              if you can spare just a meg or two, it will help alot. 
  140.              
  141.                                 Motto -> Backup!!!
  142.  
  143.                                 
  144. I have tested it with various caches (smartdrv, hyperdisk, ncache,
  145. pckwik) and with QEMM and HIMEM. I have it loaded on my system now with
  146. QEMM and Stealth mode set ST:M and it's working fine (so far!).
  147.  
  148. The program will run on just about anything. I have tested it in under 
  149. 512k of memory and it runs, but it slows way down without some memory 
  150. overhead. Better yet, throw it a meg or 2 of EMS and it will perk right 
  151. up. As with the case of most Clipper programs, the .EXE is fairly large 
  152. and on SX and/or 286 machines it will bogg down. A decent hard drive and 
  153. a sofware cache help considerably also. The cheapest and quickest way
  154. to speed this thing up is to install a software cache like NCACHE,
  155. SMARTDRV, etc. etc. etc....
  156.  
  157. You can also PKLITE the program if you own PKLITE. I didn't ship it
  158. that way because A - I don't have PKLITE, B - if any upgrades of ESD
  159. are distributed (I kinda doubt it unless a major bug) I will probably
  160. just send out patch files which will be looking for an original
  161. ESD.EXE to update.   (ex: pklite -a -e esd.exe)
  162.  
  163. =======================================================================
  164.  
  165. FILES
  166.  
  167. Use can create all new databases by just renaming or deleting 
  168. SAMPLES.DBF. Keep in mind that once you do, you'll have to start over, 
  169. copy over or append from a backup file. 
  170.  
  171. The files that must exist for the program to operate are as follows:
  172.  
  173. ESD      EXE    -       Main program file. A must have of course!
  174. EDIR     EXE    -       The EPS PC Disk Read Util by JWalas Toys. A Must!
  175.  
  176. ESD      PIF    -       Default PIF file for running under Windows
  177. ESD      ICO    -       Chintzy ICON I slapped together just to have 
  178.                         something under Windows.
  179.  
  180. SAMPLES  DBF    -       Main datafile. Created automatically.
  181. SAMPLES  DBT    -       The memo file for comments/note. Created 
  182.                         automatically with SAMPLES.DBF. If damaged or 
  183.                         deleted, the program will ask you if you want to 
  184.                         create a new one. It will be empty though and 
  185.                         all comments/notes would be lost. (Unless you 
  186.                         have some database utilities and a little 
  187.                         practice with database files but there are data 
  188.                         recovery methods if needed for both the .DBF and 
  189.                         .DBT files.)
  190. SAMPDISK NTX    - \     
  191. SAMPBLKS NTX    - \ \
  192. SAMPQUAL NTX    - / /   Automatically created index files. For EPS
  193. SAMPLES  NTX    - //     Samples.
  194. SDISK    NTX    -//
  195. SBLOCKS  NTX    -/
  196.                         Hint: Choose INDEX ORDER from the 
  197.                         Browse/Edit menu to instantly view the data 
  198.                         resorted in a different order.
  199.                         
  200.                                          Index orders
  201.                                      ---------------------
  202.                         1: SAMPDISK.NTX - Disk Number + Sample Name
  203.                         2: SAMPBLKS.NTX - Sample Name + Block Size
  204.                         3: SAMPQUAL.NTX - Qualities
  205.                         4: SAMPLES.NTX  - Sample Name
  206.                         5. SDISK.NTX    - Disk Number 
  207.                         6. SBLOCKS.NTX  - Ascending Block Size 
  208.  
  209. SMPEDM   DBF    - \  
  210. SMPEDM   DBT    - ->    Non-EPS Sample Database files. Created 
  211.                      
  212. SMPNAME  NTX     - \                                             
  213. SMPTYPE  NTX     - ->   Automatically created index files.
  214. SMPQUAL  NTX     - /    for Non-EPS Sample files.
  215.  
  216.  
  217. BAK_DATA DBF    -       Backup .DBF and .DBT file used in temp operations.
  218. BAK_DATA DBT    -       Delete if found when not running the program.
  219.                 -       Unless the program is not terminated normally, 
  220.                         they will be deleted automatically.
  221.  
  222. SFREPORT.DBF   -        List Records Report Definition files
  223. SFREPORT.NTX   -        Automatically created when you save definitions
  224. DC_QUERY.DBF   -        Saved queries are stored here
  225.  
  226. HELP DBF    - \     
  227. HELP DBT    - \ \   REQUIRED FOR THE NEW HELP SYSTEM
  228. HELP NTX    - / /   
  229.                     
  230.  
  231. RR       CNF    -\ \     
  232. RRUN     EXE    - \ \   
  233. RRUNOUT  DBF    - / /   Report writer runtime and config files. 
  234. RRUNTIME EXE    -/ /       
  235. SAMPLES  RP1   --------> Without this, no reports!!!! Cherish it...         
  236. ESD      DBF   --------> Report disctionary file. Automatically built.
  237. README   ESD   --------/ Hopefully you read this.... 
  238.  
  239.  
  240. TYPE     DBF  \
  241. TYPE     NTX   \
  242. QUALITY  DBF    \
  243. QUALITY  NTX    /   Lookup table files and indexes.
  244. SOURCES  DBF   /
  245. SOURCES  NTX  /
  246. XTENSION DBF \
  247. XTENSION NTX / -    Extension files to determine what gets imported
  248.                     into the Non-EPS database.
  249.  
  250. =====================================================================
  251.  
  252.  
  253. Quick and dirty up and running:
  254.  
  255. Just create directory (i.e., C:\SAMPLES) and then change to that 
  256. directory, copy in the files ESDxxxx.ZIP, and unzip them (PKUNZIP *).
  257. Then delete the .ZIP files to get back the disk space. Type ESD (
  258. For ESD.EXE) to run the program.
  259.  
  260.  
  261.       Press F1 for help and F1 twice for the Help Index...
  262.  
  263. =====================================================================
  264. UPGRADE INFORMATION
  265.  
  266.  
  267. February 15, 1993 - v2.01
  268.  
  269.  
  270. All lookups now show in indexed (alphabetical) ascending order after
  271. new records have been added to them. When using the lookups (Pressing
  272. F2 while on DATE, TYPE, QUALITIES, SOURCES) the records are now
  273. properly displayed in alpha order.
  274.  
  275.       Hint: To find a something in a lookup, besides using 
  276.             the up and down arrow keys, you can also just type
  277.             the first letter of what you are trying to locate 
  278.             in the lookup. You can then just press ENTER to go 
  279.             to the first that match, or keep typing in additional 
  280.             parts of the record you wish to find.
  281.  
  282. To maintain data integrity, when entering TYPE, QUALTITIES and 
  283. SOURCES and you can now leave them blank. However, if you enter 
  284. something into the field, it has to be something that exists in 
  285. the correspoding lookup table. If not, a warning message will pop-up
  286. explaining that the data you entered was "Not a Valid Entry-Not Found
  287. in Lookup Table". If you want to go ahead an enter your new value into
  288. one of the fields with lookups, you must make sure that it has been
  289. added to the lookup tables.
  290.  
  291. Fixed the jumping of the cursor after returning from FILE PACK or OTHER
  292. MENU items. The cursor now properly remains on the last menu item
  293. choosen.
  294.  
  295. Updated some of the help screens for more info and fixed a few errors
  296. in the help info.
  297.  
  298. Was a nice guy and got rid of the opening "greeting message" screen so
  299. you go right into the program.
  300.  
  301. For now removed the GO TOP and GO BOTTOM "OTHER MENU" options. There
  302. was a problem with the screen redraw and I don't have time to fix it
  303. right now.  To quickly navigate the file (other than using NEXT RECORD,
  304. PREVIOUS RECORD or KEY SEARCH: Choose TABLEVIEW and then use the up and
  305. down arrows or CTRL-PGDN to go to the bottom of the file or CTRL-PGUP
  306. to go to the top of the file.
  307.  
  308. =====================================================================
  309.  
  310. February 15, 1993 - v2.0 
  311.  
  312.  
  313. New Browse / Edit system. Not as many features as the previous one but
  314. seems to work well and probably easier for those less experienced with
  315. any type of database. 
  316.  
  317. When printing the 'canned' reports you now have the option to set an
  318. additional filter for that print job as well as it will now preview
  319. to the screen before printing if you want. You can then scroll it, 
  320. pan it, window it or more or print it out.
  321.  
  322. Some other bug fixes and changes including the label printing function
  323. for EPS disks. I have tested it quite extensively and it hasn't failed
  324. me yet. Probably just lucky on my part so far. So let me know.
  325.  
  326. -------------------------------------------------------------------
  327.  
  328. Before going any further, BACKUP your existing DATA Files if you want
  329. to keep what you have. (All *.DBF, *.NTX and *.DBT. You can also delete 
  330. the HELPFILE.* files as the new help files are named HELP.*). 
  331.  
  332. To upgrade, copy all of the files in these 2 .ZIP's into a new
  333. directory than copy all *.DBF/*.DBT/*.NTX files from the old directory
  334. into the new one (and delete HELPFILE.* not HELP.*). 
  335.  
  336. All file structures are the same so nothing will change.
  337.  
  338. If you haven't already modified your lookup files, or you were using a 
  339. version that did not use them, I have included a new copy with default
  340. types, qualities and sources:
  341.  
  342.                                 TYPES.*
  343.                                 QUALITY.*
  344.                                 SOURCES.*
  345.  
  346. That's all there is to it..... 
  347.  
  348. Use the main menu item to "Re-Index ALL files".
  349.  
  350. ---------------------------------------------------------------------
  351. Note:
  352. I would recommend that you create a new sample database and feed all
  353. your disks back into it if you are upgrading. The reason is because of
  354. EDIR. It can properly distinguish between instruments, sound banks and
  355. songs and and are now properly placed in the database. 
  356. ---------------------------------------------------------------------
  357.  
  358. That's it...
  359.  
  360.  
  361.  
  362.  
  363. HISTORY:
  364. =====================================================================
  365. 11/29/92
  366.  
  367. v1.2b
  368.  
  369. Fixed problem when a user persisted on using the program after saying NO 
  370. multiple times to create the desired files. I would force file creation 
  371. but I didn't want the users existing sample and lookup files to be blown 
  372. away in the event of an upgrade or damaged file. More file checking in 
  373. import procedures.
  374.  
  375. ESD.DBF file is now automatically created and deleted (thanks for the 
  376. Suggestion Dave!)
  377.  
  378.  
  379. =====================================================================
  380. 11/29/92
  381.  
  382. v1.2a
  383.  
  384. New feature to read in ANY file type based on a dictionary file 
  385. (XTENSION.DBF) that contains the files extension (EXT) and assigns a 
  386. TYPE to it.
  387.  
  388. There are 4 default types when the file is created:
  389.  
  390.         DIG - DIGIDESIGN
  391.         EDE - Endoniq Disk Manager DISK File
  392.         EFE - Ensoniq Disk Manager (EDM) Instrument File (IBM)
  393.         SMP - Sample Vision
  394.         
  395. You can delete, add, or change any of these. Unless the extension being 
  396. imported is found in this database, it will be bypassed. 
  397.  
  398. To edit the XTENSION.DBF file, choose VIEW / EDIT from the Main Menu and 
  399. then choose LOOKUPS and EXTENSION Tables. 
  400.  
  401. Added 3 reports to print the various file types in name, type, and 
  402. qualities order. 
  403.  
  404. Fixed a few other minor bugs and chopped some fat out of a library I was 
  405. using. This reduced both the .EXE size and memory requirements. Not a 
  406. great deal, but every little bit helps.
  407.  
  408.  
  409. =====================================================================
  410. 11/27/92
  411.  
  412. v1.1e
  413.  
  414. Fixed problem where if a user pressed F2 while in Lookup Table View 
  415. / Edit, "Variable not found" was displayed and dropped the user back to 
  416. DOS.
  417.  
  418. Changed program to enable lookups even while viewing in a filtered mode 
  419. (SEARCH/SET FILTER).  
  420.  
  421.  
  422. =====================================================================
  423. 11/26/92
  424.  
  425. v1.1d
  426. Fixed (I think permanently) the problem with using ESD with QEMM in 
  427. stealth mode. Less memory now for the DOS SHELL feature but it should me 
  428. more than enough for normal use. (Make sure command.com is in the path!)
  429.  
  430.  
  431. Fixed problem if HELPFILE not found. Now pops up warning message.
  432.  
  433. Fixed problem if trying to print from a directory other than 
  434. C:\SAMPLES. Alls the user need due is delete the file ESD.DBF. This 
  435. cause a new one to be created with the correct directory info.
  436.  
  437.  
  438. =====================================================================
  439. 11/25/92
  440.  
  441. v1.1c
  442. I fixed (again, I think I fixed) the memory problem. Seems some 
  443. computers require a larger overhead in the amount swapping out so the 
  444. swap function I use can locate a place in memory for it. I thought I was 
  445. giving it plenty but your pc doesn't like it unless i give it all 
  446. available memory to it and let it decide where and how much it wants.
  447.  
  448. If also seems that it's stealing everything QEMM can give it leaving zip 
  449. for swapping. I'm working on it....  It might run a little slower unless 
  450. you have a RAM drive. (SET TMP=The Ram Drive)
  451.  
  452. The entire import procedure was rewritten and now checks each record 
  453. being imported as to whether or not it already exists and at the same 
  454. time adds the disk number sequentially based on the last disk in the 
  455. main samples database. I beat it to death here seems to be working 
  456. great. It takes a little longer now for the import process, but it 
  457. was a necessity.
  458.  
  459. I have the lookups all done and working great. I think you will really 
  460. like this feature. You can enter long quality/keywords by just pressing 
  461. F2, locate the desired quality, and press enter, same for type and 
  462. source.
  463.  
  464. Lookups work when:
  465.  
  466.    -     You are over the TYPE, QUALITIES or SOURCE fields
  467.    -     You can enter additional TYPES, QUALITIES and SOURCES 
  468.          into the lookup tables choosing 1 followed by 3 starting
  469.          from the Main Menu. (View/Edit - LOOKUP TABLES). The same 
  470.          keys are available for all View/Browsing and Editing areas
  471.  
  472. Lookup Files:
  473.                 TYPE.DBF
  474.                 TYPE.NTX
  475.                 QUALITY.DBF
  476.                 QUALITY.NTX
  477.                 SOURCES.DBF
  478.                 SOURCES.NTX
  479.                 
  480. You can delete and start over if you want. When you load the program, 
  481. the best thing to do is run the REINDEX procedure (Menu Item #4) and 
  482. recreate these files. 
  483.  
  484. I also widened the SOURCE field from 15 to 25 spaces. If you have 
  485. samples already in your database and don't want to lose what you have, 
  486. you won't. You could do a MODIFY STRUCTURE from the util menu 
  487. and change the field from 15 to 25 manually. If you let the system 
  488. create a new database by deleting your old one, it will create it 
  489. correctly. 
  490.  
  491.  
  492.  
  493. ++++++++++++++++++++++++++++++++++++++++++++++++======================
  494.  
  495. 11/24/92
  496.  
  497. Modifed the import routine so even if a user accidently copies the same 
  498. disk twice, that disk will be bypassed and the disk number will not be 
  499. incremented. 
  500.  
  501. =====================================================================
  502.  
  503. Hints and notes:
  504.  
  505. Miscellaneous bits of helpful info. Maybe some day I'll actually write 
  506. some documentation. But, in lots of cases I feel if you need docs then 
  507. the program is too difficult to use. Then again, I'm lazy, that's why I 
  508. wrote this thing. Most people will probably not have gotten this far!
  509.  
  510.  
  511. Hints or common questions answered:
  512.  
  513. You could use the OTHER FILES Import procedure to import all kinds of 
  514. files. 
  515.  
  516. To run the program, just unzip into a directory of your choice and run 
  517. ESD.EXE. I have run it sucessfully under Windows using a default pif 
  518. file. If possible, give it some expanded memory and more preferably a 
  519. cache (around 1-2mb's does nicely).
  520.  
  521. The program will not import duplicates. I determine this by taking the 
  522. sample name, if I find that exists, I then check the block count, if 
  523. they differ it is then imported, if both name and block size are 
  524. indentical, it is bypassed.
  525.  
  526. There are three canned reports. You can print the sample listings by 
  527. Name, Disk Number, or Qualities. You can also specify a page range (in 
  528. case it jams and you have to restart this comes in very handy) and 
  529. number of copies. I only set it up for 2 basic printer types, a laser 
  530. and a dot matrix (choose 1 for laser and 2 for dot). 
  531.  
  532. By choosing list from within the View / Edit /Query you can create your 
  533. own quick little reports and print them to a file, screen or printer. 
  534. You can also set a filter (SEARCH/SET FILTER) before printing and only 
  535. those matching the filter will be printed. 
  536.  
  537. Separate database and reports for Sample Vision and EDM Format Disks 
  538.  
  539. DELETING RECORDS -  Choose OTHER MENU from the main View/Browse menu to
  540. globally delete records.
  541.  
  542. Don't forget to press F1 for help 
  543.  
  544. Keep in mind, because of the duplicate record purging, if you have 
  545. multiple disks with something like SOUNDBANK 1 on them, all but one will 
  546. be deleted. 
  547.  
  548. Another side note. Don't enter a new disk with the number 0 (ZERO). It 
  549. will be deleted. 
  550.  
  551. -------------------------------------------------------------------
  552.